Canigó - Migració de Canigó 1.x a Canigó 2.0
Important: Canvis importants a Canigó 2.0.

Si us plau, abans de continuar llegeixi atentament els canvis importants que incorpora Canigó 2.0 respecte a versions 1.x: Canvis importants a Canigó 2.0


Context

Com a conseqüència del refactor que s'ha dut a terme en el codi font del Framework Canigó l'ús dels serveis de Canigó 2.0 en els seus projectes implicarà un mínim d'actualitzacions en el codi font del seu projecte per tal que aquest funcioni correctament amb la versió 2.0 de Canigó.

Pasos a seguir per migrar de Canigó 1.x a Canigó 2.0

A continuació es mostra tot un seguit dels pasos que s'han de seguir per migrar de les versions 1.x de Canigó a la versió 2.0 de
Canigó:

project.xml
  • Actualitzar tota referència als serveis de Canigó 1.x (openFrame) al fitxer project.xml pels serveis corresponents a Canigó 2.0 (canigo):
Fitxers de configuració indicats a les versions 1.x (openFrame) Fitxers de configuració indicats a les versions 1.x (openFrame)
<dependency>
    <groupId>openFrame</groupId>
    <artifactId>openframe-services-*</artifactId>
    <version>$ {version.openframe.*}</version>
    <properties>
        <war.bundle>true</war.bundle>
    </properties>
</dependency> 		<dependency>
    <groupId>canigo</groupId>
    <artifactId>canigo-services-*</artifactId>
    <version>$ {version.canigo.*}</version>
    <properties>
        <war.bundle>true</war.bundle>
    </properties>
</dependency>
  • Actualitzar el fitxer project.properties per a canviar la versió a Canigó 2.0: "version.canigo=2.0" i revisar que totes les versions de les llibreries utilitzades estan ben definides al fitxer project.properties. Pots trobar aqui l'informe de dependències
Codi font (.java) i recursos (.xml)
  • Actualitzar tota referència als serveis de Canigó 1.x (openFrame) als fitxers *.java i *.xml pels serveis corresponents a Canigó 2.0 (canigo):
Paquets importats a les versions 1.x (openFrame) Paquets a importar a la versió 2.0 (canigo)
net.opentrends.openframe.services.* net.gencat.ctti.canigo.services.*
Fitxer .classpath
  • Actualitzar tota referència als serveis de Canigó 1.x (openFrame) al fitxer .classpath per tal que s'agafin els jars corresponents a la versió 2.0 de Canigó:
Llibreria importada a les versions 1.x (openFrame) Llibreria a importar a la versió 2.0 (canigo)
<classpathentry kind="var" path="MAVEN_REPO/openFrame/jars/openFrame-services-*.jar"/> <classpathentry kind="var" path="MAVEN_REPO/canigo/jars/canigo-services-*.jar"/>

Es pot fer servir el goal de refresc del classpath d'eclipse que està definit a maven.xml

Migració de Maven 1.0.2 a Maven 2.0.
  • Els projectes que ja van començar amb Maven 1.0.2 no necessiten migrar a Maven 2.0. Només caldrà fer els canvis al project.xml i project.properties ja comentats.
  • Si vols passar a Maven 2.0 cal saber que tots els serveis de Canigó 2.0 s'han construït fent servir l'eina Maven 2.0, a diferència dels serveis de Canigó 1.x que es construien fent servir Maven 1.0.2. A Maven 2.0 cal generar un fitxer pom.xml que inclogui com construir el projecte, on estàn ubicats els repositoris, així com les dependències del projecte. Aquí pots trobar els passos a seguir per a la migració a Maven 2.0 d'un projecte Maven 1.0

Projectes nous fent servir, des del començament, Canigó 2.0

 Per tots aquells projectes nous que facin servir Canigó 2.0 cal que tinguin present que els cal:

  • Maven 2.0
    • Tots els serveis de Canigó 2.0 s'han construït fent servir l'eina Maven 2.0, a diferència dels serveis de Canigó 1.x que es construien fent servir Maven 1.0.2. A Maven 2.0 cal generar un fitxer pom.xml que inclogui com construir el projecte, on estàn ubicats els repositoris, així com les dependències del projecte. Si vols iniciar el projecte a partir d'un ja existent però amb Maven 1 segueix les instruccions de migració. Si el comences de nou pots anar a la documentació de Maven per a veure como iniciar
  • Spring 2.0